home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / 1edra101.zip / 1EDIT-RA.DOC next >
Text File  |  1990-05-06  |  35KB  |  1,255 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                       ┌─────────────────────────────────┐
  18.                       │ ┌─────────────────────────────┐ │
  19.                       │ │    -*-  1-EDIT-RA  -*-      │ │
  20.                       │ └─────────────────────────────┘ │
  21.                       └─────────────────────────────────┘
  22.  
  23.  
  24.                                 Version: 1.01
  25.  
  26.                                      For
  27.  
  28.                                  RemoteAccess
  29.  
  30.  
  31.                                       by
  32.  
  33.  
  34.                                   Bob Ransom
  35.  
  36.  
  37.  
  38.                               Copyright (c) 1990
  39.                              All Rights Reserved
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.                    ┌───────────────────────────────────────┐
  76.                    │          TABLE OF CONTENTS            │
  77.                    └───────────────────────────────────────┘
  78.  
  79.  
  80.  
  81.           What Is 1-EDIT-RA? ..............................  2
  82.           Acknowledgements ................................  3
  83.           Special Notes to RA Users .......................  4
  84.           Shareware & Warranty ............................  5
  85.           FOSSILS, ANSI.SYS & Other Requirements ..........  6
  86.               LOCAL.DEF File ..............................  6
  87.               Locked COM Ports ............................  7
  88.           Command Line Syntax .............................  9
  89.               Colors ......................................  9
  90.               Drop To DOS Security ........................  9
  91.               USERS.BBS Backups ...........................  9
  92.           Getting Started ................................. 10
  93.               Setting Up 1-EDIT-RA Within RemoteAccess .... 10
  94.           Drop To DOS ..................................... 11
  95.               Local Drop To DOS ........................... 12
  96.               Remote Drop To DOS .......................... 12
  97.           The MENU Editor ................................. 14
  98.           The USER Editor ................................. 15
  99.               Mass User Updates ........................... 15
  100.           Registering 1-EDIT-RA ........................... 17
  101.               Keys ........................................ 17
  102.               Installing Keys ............................. 17
  103.           Final Notes ..................................... 18
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.           1-EDIT v1.01                                  Page 1
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.                    ┌───────────────────────────────────────┐
  143.                    │           WHAT IS 1-EDIT-RA?          │
  144.                    └───────────────────────────────────────┘
  145.  
  146.  
  147.  
  148.           1-EDIT-RA is a combined User Editor and Menu Editor for
  149.           RemoteAccess systems designed to work reliably from
  150.           remote.  Features include:
  151.  
  152.                     - Built-in FOSSIL routines for guaranteed remote
  153.                     performance.
  154.  
  155.                     - Full carrier detection which returns to
  156.                     RemoteAccess when carrier is dropped.
  157.  
  158.                     - Automatic high speed performance with locked
  159.                     ports at up to 38,400 baud (and possibly
  160.                     higher).
  161.  
  162.                     - Status line showing user name, baud and modem
  163.                     settings, and time remaining.
  164.  
  165.                     - Drop to DOS functions while online.
  166.  
  167.                     - User-definable colors.
  168.  
  169.                     - Full editing capabilities of nearly all fields
  170.                     in the USERS.BBS file.
  171.  
  172.                     - Mass flag updating of user records.
  173.  
  174.                     - Mass "High Message Read" updating of all user
  175.                     records.
  176.  
  177.                     - Full menu editing capabilities including
  178.                     adding and deleting menus, renaming menus,
  179.                     copying menus, plus direct editing of each line
  180.                     of the menu record.  Direct editing allows you
  181.                     to insert, delete, change, and list the lines of
  182.                     the edited menu, plus full menu simulation.
  183.  
  184.                     - Small file size: the program is only around
  185.                     69K and will run in about 84K of memory.  This
  186.                     allows 1-EDIT-RA to run easily from a Type 7
  187.                     shell.
  188.  
  189.  
  190.  
  191.  
  192.           1-EDIT v1.01                                  Page 2
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.                    ┌───────────────────────────────────────┐
  208.                    │           ACKNOWLEDGEMENTS            │
  209.                    └───────────────────────────────────────┘
  210.  
  211.  
  212.  
  213.           A big hearty "Thank You" to all those trusting soles who
  214.           opened up their machines and systems files to me to help
  215.           beta test this software.  To make sure it works, a program
  216.           needs to be tested on as many setups as possible and the
  217.           owners of those systems must be willing to really give the
  218.           program a workout.  These guys have.  Thanks to Barron
  219.           Featherston, Bob Holiday, Chris Lamprecht, Jim Roe, Jim
  220.           Westbrook, Bill Chambers, George Vandervort, and John
  221.           Parlin.
  222.  
  223.           Additional thanks go to John Parlin for creating such a
  224.           great FOSSIL interface for Turbo Pascal programmers.  His
  225.           JPDOOR makes programming doors a breeze.  Some background
  226.           is warranted here:  I began this program well over a year
  227.           ago, using FOSSIL and door routines that I wrote myself.
  228.           My package was decent and workable -- not great, mind you,
  229.           but not bad.  However, it never did all the things I
  230.           wanted it to do so development was put on hold for quite
  231.           a while.  Then I took a look at John's package, yelled
  232.           "Eureka!" loudly, promptly ditched my door units and
  233.           replaced them with his, and began the final work on
  234.           1-EDIT-RA.  If you're interested in writing doors of your
  235.           own in TP, definitely take a look John's package.
  236.           Registration for it is only $15 and it is *very* complete,
  237.           including .TPU's for TP 4.0, TP 5.0, and TP 5.5.
  238.  
  239.           Special thanks also go to Mike Janke for help in
  240.           converting the data structures used by this program from
  241.           QuickBBS to RemoteAccess.
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.           1-EDIT v1.01                                  Page 3
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.                    ┌───────────────────────────────────────┐
  274.                    │      SPECIAL NOTES TO RA USERS        │
  275.                    └───────────────────────────────────────┘
  276.  
  277.  
  278.           As originally written, 1-EDIT was (is) a QuickBBS remote
  279.           editor.  Because of the similarities between QuickBBS and
  280.           RemoteAccess, adding RA support to the original program
  281.           would have been pretty easy.  I intended to put the
  282.           program into RemoteAccess mode by means of a command line
  283.           switch.  But then I started thinking....
  284.  
  285.           Right now, RA and Quick are pretty close to one another
  286.           structurally, but what's it going to be like in a few
  287.           months?  The data structures are already starting to go
  288.           their separate ways.  In a few months, with changes in
  289.           both programs, they could be miles apart.  Why not prepare
  290.           for it now?
  291.  
  292.           So I hacked some more and came up with an RA-specific
  293.           program, 1-EDIT-RA.  I think that by doing this,
  294.           maintaining support for both programs will be easier -- I
  295.           won't have to worry about changes made in one piece of
  296.           code effecting one system or the other when it shouldn't.
  297.           Anyway, while having two very similar versions floating
  298.           around may be confusing to some, I think it will pay off
  299.           in the long run.
  300.  
  301.           The release of the first version of 1-Edit-RA was probably
  302.           a bit premature as I didn't take advantage of some of the
  303.           things special to RA - i.e. different paths to the
  304.           USERS.BBS and system files.  That's been fixed (along with
  305.           several other things) in this version.  And, next time,
  306.           somebody slap me if I try to release something too soon.
  307.  
  308.           So, that's where that stands.
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.           1-EDIT v1.01                                  Page 4
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.                    ┌───────────────────────────────────────┐
  340.                    │     1-EDIT-RA: SHAREWARE & WARRANTY   │
  341.                    └───────────────────────────────────────┘
  342.  
  343.  
  344.  
  345.           Here comes the dull but necessary stuff:
  346.  
  347.           SHAREWARE INFO
  348.  
  349.           This program is released to the public as shareware.  This
  350.           means try it and if you like it, you must register it
  351.           within a reasonable amount of time.  The program is not
  352.           freeware nor public domain; it is copyrighted material
  353.           with all rights reserved.  You are granted only a limited
  354.           license to test this software.  No changes whatsoever may
  355.           be made.
  356.  
  357.           You may copy 1-EDIT-RA and transfer it to others provided
  358.           you follow these brief rules:
  359.  
  360.           1- You may not change the program, its archive, or its
  361.           documentation in anyway without express written consent
  362.           from me, the author.
  363.  
  364.           2- You may not sell the program.  This program may be
  365.           distributed on pay systems, but not on a
  366.           "fee-per-download" basis.
  367.  
  368.           3- You may not distribute this product with other products
  369.           without express written consent from me.
  370.  
  371.           Registration of 1-EDIT-RA is a cheap $10 and covers you
  372.           for all future releases of the program.  More information
  373.           on registering is included later in this document.
  374.  
  375.  
  376.           WARRANTY
  377.  
  378.           No warranty of any kind, covering either hardware or
  379.           software damage, is expressed nor implied.  Use this
  380.           program at your own risk.
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.           1-EDIT v1.01                                  Page 5
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.               ┌─────────────────────────────────────────────────┐
  406.               │   FOSSILS, ANSI.SYS, and OTHER REQUIREMENTS     │
  407.               └─────────────────────────────────────────────────┘
  408.  
  409.  
  410.  
  411.           There are a few things you should know before attempting
  412.           to boot 1-EDIT-RA for the first time:
  413.  
  414.  
  415.           FOSSIL Driver
  416.  
  417.           1-EDIT-RA requires a FOSSIL driver to be installed and
  418.           active at all times.  This shouldn't prove to be much of a
  419.           hindrance since 1-EDIT-RA was designed for remote use.  If
  420.           you are editing strictly from the local console, RACE and
  421.           RAMenu do the same job faster and nicer, and they *don't*
  422.           require a FOSSIL.  (However, they're not meant for remote
  423.           use, either.)  1-Edit-RA has been tested with both the X00
  424.           driver and the BNU driver; both work fine.  One note to
  425.           BNU users who use the TSR version of the program: Be sure
  426.           that you're not having BNU remove itself from memory when
  427.           you exit your BBS and/or mailer.
  428.  
  429.  
  430.           ANSI Graphics
  431.  
  432.           1-EDIT-RA requires all users of the program to have the
  433.           ANSI.SYS driver installed - both on the BBS and remote
  434.           caller's systems.  99.9% of sysops do have it installed so
  435.           this shouldn't be a problem.  If you're unfamiliar with
  436.           ANSI.SYS, see your DOS manual.  ANSI.SYS is included with
  437.           all versions of DOS.
  438.  
  439.  
  440.           DORINFO1.DEF & LOCAL.DEF
  441.  
  442.           1-EDIT-RA requires a DORINFO1.DEF file to be present when
  443.           starting.  First, some background on this file and how to
  444.           get around the necessity of having it:  When RemoteAccess
  445.           shells to another program, either through a menu Type 7
  446.           exit or a menu Type 15 exit, it creates two files in your
  447.           system directory: DORINFO1.DEF and EXITINFO.BBS.  Both
  448.           contain information for the child program to use in
  449.           determining the user's name, baud rate and modem settings,
  450.           graphic settings, etc.  When you return to RemoteAccess
  451.           from the shell, RemoteAccess deletes both of these files.
  452.           That's why you can never find them on your disk -- they're
  453.           already gone.
  454.  
  455.           Because 1-EDIT-RA requires DORINFO1.DEF and because a copy
  456.           1-EDIT v1.01                                  Page 6
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.           won't always be available, I've made the program search
  472.           for a second file called LOCAL.DEF.  LOCAL.DEF is nothing
  473.           but a copy of DORINFO1.DEF which should stay in your main
  474.           RA system directory (usually "C:\RA").  When run,
  475.           1-EDIT-RA will first search for the DORINFO1.DEF file.  If
  476.           it's not found, it will then try to find the LOCAL.DEF
  477.           file.  If that's not found, the program aborts.  If it
  478.           *is* found (remember, you're supposed to leave it on your
  479.           disk so it should be there), 1-EDIT-RA will copy it over
  480.           to DORINFO1.DEF.  When you quit 1-EDIT-RA, the
  481.           DORINFO1.DEF file will be deleted.
  482.  
  483.           A copy of LOCAL.DEF is included in the 1-EDIT-RA archive
  484.           which you may edit to reflect your name and system name.
  485.           Here's what it looks like with my comments in braces { }:
  486.  
  487.           -------------------------------------------------------
  488.           THE CREATIVE CONNECTION-SOUTHFIELD, MI-(313)559-9039
  489.           BOB                    {Sysop first name}
  490.           RANSOM                 {Sysop last name}
  491.           COM0                   {Don't edit this!}
  492.           0 Baud,N,8,1           {No need to edit this}
  493.           0                      {This does nothing - just a zero}
  494.           BOB                    {User first name}
  495.           RANSOM                 {User last name}
  496.           LATHRUP VILLAGE, MI    {No need to edit; not used}
  497.           1                      {1=Graphics.  Don't edit}
  498.           32000                  {User security level}
  499.           235                    {User time remaining}
  500.           -------------------------------------------------------
  501.  
  502.           Feel free to edit your copy of LOCAL.DEF to reflect the
  503.           proper sysop names and user names.  The COM port setting
  504.           MUST remain as COM0 -- this indicates a local connect.
  505.           Changing the security and time remaining is up to you.
  506.           Time remaining is not counted while in local.  After
  507.           editing, place the LOCAL.DEF in your RA system directory
  508.           and leave it there.
  509.  
  510.           Locked COM Ports
  511.  
  512.           Locked COM ports are supported automatically by 1-EDIT-RA.
  513.           There is no need to use DorSpeed, SetSpeed, etc.
  514.           1-EDIT-RA has been successfully tested at speeds up to
  515.           38,400 baud.
  516.  
  517.           Directories
  518.  
  519.           1-Edit-RA may be run from any directory you choose.  When
  520.           first started, it searches your DOS environment for "SET
  521.           RA=", then uses that path to find the CONFIG.RA,
  522.           1-EDIT v1.01                                  Page 7
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.           DORINFO1.DEF, and LOCAL.DEF files.  If you don't have the
  538.           RA environment variable set (you should already), please
  539.           set it.  See your RA docs for more info.
  540.  
  541.           Also, 1-Edit-RA expects to find your USERS.BBS in the path
  542.           defined in CONFIG.RA as "Message base directory."  Your
  543.           CONFIG.RA should already be pointing to the proper
  544.           directory.
  545.  
  546.  
  547.           Okay, that takes care of the requirements.  Now, you've
  548.           unZIPped the 1-EDIT-RA file and put it somewhere on your
  549.           hard drive, and put the edited LOCAL.DEF into your RA
  550.           system directory.  Now you're almost ready to get started.
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.           1-EDIT v1.01                                  Page 8
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.                    ┌───────────────────────────────────────┐
  604.                    │         COMMAND LINE SYNTAX           │
  605.                    └───────────────────────────────────────┘
  606.  
  607.  
  608.  
  609.           1-EDIT-RA allows you to customize it somewhat via the
  610.           command line.  Four parameters may be included if you wish
  611.           (they're optional):
  612.  
  613.           -Fxx     Sets foreground color to xx.  xx must be 0-7.
  614.                    Default color is cyan (#3).
  615.  
  616.           -Hxx     Sets the highlight color to xx.  xx must be 0-15.
  617.                    Default highlight color is bright yellow (#14).
  618.  
  619.           -Sxxxxx  Sets the minimum security level for the Drop to
  620.                    DOS feature to xxxxx.  xxxxx must be 0-32000.
  621.                    Default is 32000.  More on this feature later.
  622.  
  623.           -B       Tells 1-Edit-RA to make a backup of USERS.BBS
  624.                    before entering the User Editor.  Default is to
  625.                    NOT make a backup.  While most often you won't
  626.                    need this option, you may wish to use it if
  627.                    plagued by noisy phone lines.
  628.  
  629.           ?        Brings up very short help screen describing
  630.                    command line parameters.
  631.  
  632.           None of these parameters are required; use any, all, or
  633.           none of them as you choose.  The command line may be in
  634.           upper case or lower; it doesn't matter.
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.           1-EDIT v1.01                                  Page 9
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.                    ┌───────────────────────────────────────┐
  670.                    │           GETTING STARTED             │
  671.                    └───────────────────────────────────────┘
  672.  
  673.  
  674.  
  675.           With that boring stuff out of the way, we'll get on to the
  676.           meat of the program.  I'm not going to bother taking you
  677.           through each and every option in the editors -- most
  678.           commands are pretty self-explanatory, so I'll just touch
  679.           on most of it and highlight oddities, etc.  Any sysop that
  680.           has gotten a RemoteAccess system up and running shouldn't
  681.           have any problems.
  682.  
  683.  
  684.           Setting Up 1-EDIT-RA Within RemoteAccess
  685.  
  686.           1-EDIT-RA has been tested under both a RemoteAccess Type 7
  687.           exit and a Type 15 exit; either setup will work just fine.
  688.           However, because of its small size, 1-EDIT-RA is probably
  689.           best run as a Type 7 except on systems with very tight
  690.           memory constraints (i.e. Desqview and DoubleDOS systems).
  691.           For Desqview/DoubleDOS users: As best as I can tell,
  692.           1-EDIT-RA runs in about 84K of memory.
  693.  
  694.           Here's a sample of how a Type 7 setup would look from
  695.           within RAMENU:
  696.           ---------------------------------------------------------
  697.                                Edit Menu Item
  698.  
  699.                    1         2         3         4         5
  700.           1234567890123456789012345678901234567890123456789012345678
  701.           <^1^> ............  Run 1-EDIT-RA Editor
  702.  
  703.           Optional Data:
  704.           \command.com /c 1EDIT.EXE -F7 -H15 -S100 -B
  705.  
  706.           User Display
  707.           Action            Execute sub-program (Type 7)
  708.           Optional data
  709.           Hot-Key           1
  710.           Automatic         No
  711.           Colour            Colour example
  712.           Security          32000
  713.           Flags-A           --------
  714.           Flags-B           --------
  715.           Flags-C           --------
  716.           Flags-D           --------
  717.  
  718.           ---------------------------------------------------------
  719.  
  720.           1-EDIT v1.01                                  Page 10
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.           As mentioned earlier, the -F, -H, -S, and -B command line
  736.           parameters are completely optional; leave them off if
  737.           you're happy with the defaults.
  738.  
  739.  
  740.           Actual Startup
  741.  
  742.           When you first start 1-EDIT-RA, it will check to see that
  743.           a FOSSIL is present.  If not, the program aborts.  From
  744.           there it begins its search for DORINFO1.DEF, using
  745.           LOCAL.DEF if necessary.  Some values are initialized, then
  746.           an opening screen pops up.  If you haven't registered your
  747.           program yet, the program will ring the bell a few times,
  748.           then pause for 4 seconds to <ahem> encourage registration.
  749.           After the pause you'll be prompted to "Press [ENTER] to
  750.           continue:".  Press enter and  you'll get the main menu.
  751.  
  752.           From the main menu you may choose to edit user files, menu
  753.           files or drop to DOS.  At this point, registered versions
  754.           of 1-EDIT-RA will show a status line on the local console
  755.           detailing who's online, baud and modem settings, and time
  756.           remaining.  Unregistered versions show only the line
  757.           "Unregistered Evaluation Copy."
  758.  
  759.           A side note that applies here and throughout most of the
  760.           program: Pressing [ENTER] or entering a question mark will
  761.           redraw the screen.  This is really only useful in times of
  762.           high line noise, but it's nice to have available when you
  763.           need it.
  764.  
  765.  
  766.  
  767.                    ┌───────────────────────────────────────┐
  768.                    │         DROP TO DOS FEATURE           │
  769.                    └───────────────────────────────────────┘
  770.  
  771.  
  772.  
  773.           This feature can be both very useful and very dangerous,
  774.           so please read this section carefully.  Before attempting
  775.           to use the Drop to DOS feature, be sure your CONFIG.SYS
  776.           file sets COMSPEC=<path to COMMAND.COM>.  1-EDIT-RA uses
  777.           that DOS environment variable to tell it where to find
  778.           COMMAND.COM.  For more info on CONFIG.SYS files and
  779.           setting COMSPEC, see your DOS manual.  If you wish to test
  780.           whether COMSPEC= is set or not, type SET at any DOS
  781.           prompt.  This will cause DOS to display your environment
  782.           settings
  783.  
  784.           When displaying the main menu, 1-EDIT-RA checks the users
  785.           security level (set in DORINFO1.DEF) against the security
  786.           1-EDIT v1.01                                  Page 11
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.           level set on the command line (or the default, 32000).  If
  802.           the user's level equals or exceeds that level, the Drop to
  803.           DOS function appears on the main menu.  If the user's
  804.           security level is *less* than the specified level, the
  805.           option doesn't even show up as an option.  This allows you
  806.           to have co-sysops be able to edit your BBS files without
  807.           actually cutting them loose in DOS.
  808.  
  809.  
  810.           LOCAL DROP TO DOS
  811.  
  812.           Drop to DOS works two different ways, depending on whether
  813.           you're calling locally or remotely.  When in local mode,
  814.           the drop to DOS is just a very simple shell.  You hit "D"
  815.           and you get the familiar flashing cursor.  (What actually
  816.           happens is a second copy of COMMAND.COM is loaded.)  You
  817.           may run whatever files you need to run from here.  When
  818.           ready to return to 1-EDIT-RA, simply type EXIT.
  819.  
  820.  
  821.           REMOTE DROP TO DOS
  822.  
  823.           Things become a bit more complicated when dropping to DOS
  824.           remotely because 1-EDIT-RA goes on hold during the shell.
  825.           This is similar to Type 7 and Type 15 exits out of
  826.           RemoteAccess -- when you shell out, you loose RA's ability
  827.           to send things through the modem, watch carrier and time
  828.           remaining, etc.  The same happens when you shell out of
  829.           1-EDIT-RA -- whatever you shell to must take over all
  830.           modem functions including FOSSIL interface, carrier
  831.           detect, etc.  Because of this, a warning pops up when
  832.           executing the shell reminding you not to go and try to
  833.           load WordPerfect or some other program that has no modem
  834.           routines.
  835.  
  836.           When you do execute the shell, you're prompted to enter a
  837.           filename to execute.  Leave this field blank and 1-EDIT-RA
  838.           will return to the main menu.  If you do execute a program
  839.           or batch file, BE SURE TO INCLUDE THE FILE EXTENSION WITH
  840.           THE FILENAME (i.e. ".EXE", ".COM", ".BAT").  You may also
  841.           include as many command line parameters as you can fit
  842.           into the field.  These parameters will be passed on to the
  843.           child program.  When you exit the child program, you'll be
  844.           returned automatically to 1-EDIT's main menu.
  845.  
  846.           A sample batch file called DOSSHELL.BAT is included in the
  847.           archive for you to look over.  It details how you can set
  848.           up a true drop to DOS from 1-EDIT-RA using CTTY COMx or (a
  849.           better method using Gateway) CTTY GATEx.  If you try this
  850.           out, be sure to pass your baud rate to the batch file on
  851.           the command line as: DOSSHELL.BAT 2400  (or whatever rate
  852.           1-EDIT v1.01                                  Page 12
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.           you're using).  This batch file should be tested CAREFULLY
  868.           before relying on it!!!!  Also, I'd suggest you give
  869.           serious consideration to adding WATCHCD or some other
  870.           carrier watcher to the batch file so that the carrier is
  871.           monitored while in the shell.
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.           1-EDIT v1.01                                  Page 13
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.                    ┌───────────────────────────────────────┐
  934.                    │           THE MENU EDITOR             │
  935.                    └───────────────────────────────────────┘
  936.  
  937.  
  938.  
  939.           Those of you familiar with Adam Hudson's original Menuedit
  940.           will feel right at home here.  When you first choose the
  941.           menu editor from the main menu, you'll be presented with a
  942.           directory of the menus in your RemoteAccess menu area.
  943.           1-EDIT-RA uses the CONFIG.RA file to determine the path to
  944.           this area.  After displaying all of the menus you'll have
  945.           the option of editing/adding a menu, renaming a menu,
  946.           copying a menu, deleting a menu, or relisting the files.
  947.  
  948.           There's no need to explain most of these functions.  One
  949.           thing you might like to know is that any rename, delete,
  950.           or copy operation can be stopped by pressing [ENTER] on a
  951.           blank input field.
  952.  
  953.           Choose the <E> option and you'll be prompted for the menu
  954.           filename to edit.  Input the name.  If the menu isn't
  955.           found, you'll be asked if you wish to create it.  After
  956.           entering the menu name, you'll be dropped onto the main
  957.           menu editor menu.  From here you can do a variety of
  958.           things, all very similar to the same functions in
  959.           Menuedit.
  960.  
  961.           Rather than beat a dead horse trying to detail each
  962.           section of this menu, you should just play with it a bit.
  963.           It's pretty easy.  Start by copying a menu, any menu, to
  964.           another menu file called, maybe, TEST or FRED or
  965.           something.  Then hack on that copied menu.  You'll get the
  966.           hang of it pretty quickly (like instantly, I hope).
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.           1-EDIT v1.01                                  Page 14
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.                    ┌───────────────────────────────────────┐
  1000.                    │           THE USER EDITOR             │
  1001.                    └───────────────────────────────────────┘
  1002.  
  1003.  
  1004.  
  1005.           Most all of this section should be pretty easy to figure
  1006.           also.  For the most part, everything is self-explanatory.
  1007.           Press the plus key (+) for the next user or the minus key
  1008.           (-) for the previous user.  When moving from user to user,
  1009.           if you hit the beginning or end of the USERS.BBS file, the
  1010.           program will "wrap around" for the next user.  Example:
  1011.           You come to the last user in the file, say user #100, then
  1012.           press the plus key (+).  1-EDIT-RA will "wrap around" to
  1013.           user #0.
  1014.  
  1015.           Pick and choose the fields you need to edit, press the
  1016.           bracketed key <>, and you edit to your heart's content.
  1017.           One note of interest: Should you go to edit a field and
  1018.           then decide not to change anything, just press [ENTER] and
  1019.           that field will remain unchanged.
  1020.  
  1021.           At the bottom of the screen, you'll see a small window
  1022.           with choices to add a user, delete a user, toggle NO-KILL
  1023.           and other flags, etc.  <Q>uit takes you back to the main
  1024.           menu.  <O>ther clears this small window and replaces it
  1025.           with a different set of options that allow you to make
  1026.           mass updates to flags or high message read numbers (see
  1027.           below), and to edit some of the other user fields that
  1028.           aren't often edited.  To return to the first set of
  1029.           options, press <O> again.
  1030.  
  1031.  
  1032.           MASS UPDATES
  1033.  
  1034.           From the <O>ther window, you have the ability to do mass
  1035.           updates to flags and high message read numbers.  What's
  1036.           this good for?  Well, a couple of things:
  1037.  
  1038.           Some of you use a combination auto-executed menu options
  1039.           and flags to show your BBS users a news file.  After they
  1040.           read the file, you set that flag to OFF.  When you create
  1041.           a new news file, you must go back and turned everyone's
  1042.           flag back on again.  Mass Flag Upd. allows you to do that.
  1043.           You're asked for the flag you wish to set (A, B, C, or D),
  1044.           the flag position to set (1-8), and whether you want it on
  1045.           or off.  After entering the information, 1-EDIT-RA will go
  1046.           through and reset that flag bit for each user in the
  1047.           USERS.BBS.
  1048.  
  1049.           Mass updating of high message read is usually good after
  1050.           1-EDIT v1.01                                  Page 15
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.           you either bomb your message base, or do a slightly messed
  1066.           up message renumber.  I've had a few occasions where my
  1067.           message base has gotten destroyed and I've had to delete
  1068.           all the files.  After doing so, all the user records still
  1069.           contain the old high message read numbers, so the users
  1070.           all get the "No new messages" line when they attempt to
  1071.           read new messages.  Using this mass update option lets you
  1072.           reset everybody's high read number back to 0 (or whatever
  1073.           number you want).
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.           1-EDIT v1.01                                  Page 16
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.                    ┌───────────────────────────────────────┐
  1132.                    │          REGISTERING 1-EDIT-RA        │
  1133.                    └───────────────────────────────────────┘
  1134.  
  1135.  
  1136.  
  1137.           KEYS
  1138.  
  1139.           1-EDIT-RA uses a "keyed" registration system.  The
  1140.           information used to create your key is your system name
  1141.           and sysop name as contained in your CONFIG.RA file.
  1142.           Unregistered versions of the program (programs running
  1143.           without the key) ring the bell and have a 4 second pause
  1144.           built in at the beginning of the program, plus the status
  1145.           line is disabled.  Registered versions will also show the
  1146.           registered system name and sysop name during the opening
  1147.           screen (i.e. "Registered to: Creative Connection  Bob
  1148.           Ransom").  These are the only differences between
  1149.           registered and unregistered copies.  1-EDIT-RA has no
  1150.           built in self-destruct mechanisms or other disgusting
  1151.           things.
  1152.  
  1153.           When you register 1-EDIT-RA, you'll receive a small key
  1154.           file that will disable the bell ringing and pause, and
  1155.           enable the status line.  If you hold a valid Fidonet node
  1156.           number, your key file will be sent to you through netmail
  1157.           file attach.  Sysops who aren't a part of Fidonet or who
  1158.           are outside of the continental U.S. and Canada will
  1159.           receive their key files on a disk through the mail.
  1160.  
  1161.  
  1162.           INSTALLING KEYS
  1163.  
  1164.           When you receive your key file, it will be named something
  1165.           like LASTNAME.KEY (where LASTNAME is your last name).
  1166.           Place this key file into the directory where 1-EDIT-RA
  1167.           will be running from and rename it 1EDIT-RA.KEY.  Repeat:
  1168.           It must be in the same directory as 1-Edit-RA!  Be sure to
  1169.           check your spelling here: "1-EDIT-RA.KEY" won't work; only
  1170.           "1EDIT-RA.KEY" will.
  1171.  
  1172.           Leave this key in place for as long as you use 1-EDIT-RA.
  1173.           It will be good for all future releases of the program.
  1174.           If for some reason I should need to make a change in the
  1175.           key encryption routines (which would invalidate your key),
  1176.           a new key will be sent to you immediately.
  1177.  
  1178.           REGISTERING
  1179.  
  1180.           A registration form called REGISTER.DOC is included in the
  1181.           1-EDIT-RA archive.  Please complete this form and mail it
  1182.           1-EDIT v1.01                                  Page 17
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.           with your check or money order for $10 (U.S. funds) to the
  1198.           address on that form.  You key will be sent to you within
  1199.           a few days of receipt of your check.
  1200.  
  1201.  
  1202.  
  1203.  
  1204.                    ┌───────────────────────────────────────┐
  1205.                    │               THE END                 │
  1206.                    └───────────────────────────────────────┘
  1207.  
  1208.  
  1209.  
  1210.           Okay, I guess that wraps it up.  Hopefully this document
  1211.           is complete enough that you can set up and run 1-EDIT-RA
  1212.           without problems.  Should you encounter a problem of some
  1213.           kind or an unfound bug, please be sure to let me know.
  1214.           Suggestions for enhancements are always welcomed, too.
  1215.           You can contact me through the RemoteAccess Support echo,
  1216.           the QuickBBS Support echo, the QuickPro echo, or by
  1217.           netmail.
  1218.  
  1219.           The current version of this program is available for file
  1220.           request from my system under the magic name of 1EDIT-RA.
  1221.           First time callers can also download the program from the
  1222.           QuickBBS Files section.
  1223.  
  1224.           -Bob Ransom
  1225.            27840 Lathrup Blvd.
  1226.            Lathrup Village, MI  48076
  1227.  
  1228.            The Creative Connection BBS
  1229.            24 hours / 7 days
  1230.            300-1200-2400 Baud / 8-N-1
  1231.            313/559-9039
  1232.            1:120/96
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.           1-EDIT v1.01                                  Page 18
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.